# Kumo SSB Manager

Pepvoid can include Kumo, a graphical Site-Specific Browser manager for creating
isolated desktop entries for web applications.

Enable it with:

```sh
sudo python3 cli.py x86_64 --desktop xfce --with-kumo --mode real
```

The `kumo` profile installs the system Python dependencies from XBPS and copies
the bundled runtime into the image. It does not use `pip`, a developer virtual
environment, or a source checkout at runtime. This keeps real builds
reproducible and allows `--with-custom-repo` to reuse already indexed custom
Python packages.

Installed files:

- `/usr/share/kumo`: application runtime, translations and image assets.
- `/usr/bin/kumo`: system launcher.
- `/usr/share/applications/kumo.desktop`: desktop menu entry.
- `/usr/share/pixmaps/kumo.png`: application icon.

Kumo detects installed browsers and uses `xdg-open` or the selected browser
command to launch each SSB. Browser installation remains optional and is only
requested when the user chooses it from the application.

## Updating the bundled runtime

Refresh the runtime from a Kumo checkout with:

```sh
python3 tools/sync_kumo.py configs/custom_files/kumo/app
```

The synchronisation script excludes virtual environments, caches, generated
documentation and bytecode.